##############################################################################
###+------------+#############################################################
#+-| GET_EXEC() |--------------------------------+############################
#| +------------+ Returns the full path names of |############################
#|                the currently running program  |############################
#+-----------------------------------------------+############################
##############################################################################
##############################################################################
#+--| Summary |----------------+##############################################
#|     #INCLUDE system.hdr     |##############################################
#+-----------------------------+##############################################
##############################################################################
##############################################################################
#+--| Syntax |------------------------------+#################################
#|     FUNCTION CHAR get_exec PROTOTYPE     |#################################
#+------------------------------------------+#################################
##############################################################################
##############################################################################
##########+---| Description |--------------------------------------+##########
##########| The get_exec() function returns the full path names of |##########
##########| the currently running program.  Use get_exec() to      |##########
##########| indicate how a user invokes a program.                 |##########
##########+--------------------------------------------------------+##########
##############################################################################
##############################################################################
#########+--| Example 1 |-------------------------------------------+#########
#########| *    If current program is started from directory        |#########
#########| *    "c:\acct\bin\mainmenu.exe" ...                      |#########
#########|                                                          |#########
#########| ? get_exec()    && returns "C:\ACCT\BIN\MAINMENU.EXE"    |#########
#########|                                                          |#########
#########| *--- If user types: "C> d:\tools\gb " to start           |#########
#########| *    the program "gb.exe", then ...                      |#########
#########|                                                          |#########
#########| ? get_exec()    && returns "D:\TOOLS\GB.EXE"             |#########
#########+----------------------------------------------------------+#########
##############################################################################